QuickTime 3 Reference

Supplying Parameter Description Information

Your effect must supply information to client software that describes the parameters that your effect takes. Each parameter is described using a specific format, which is described in "The Parameter Description Format" .

The easiest way to supply this information back to the client software is to add an 'atms' resource to your component. The 'atms' resource contains the parameter descriptions in the required format. You can retrieve the resource by calling the GetComponentResource function, as shown in Listing 19 .

Listing 19 An implementation of the GetParameterListHandle function



 
pascal ComponentResult GetParameterListHandle(EffectGlobals *glob,

                                                Handle *theHandle)

{

    OSErr   err = noErr;



    err = GetComponentResource((Component) glob->self,

                        OSTypeConst('atms'),

                        kEffectatmsRes,

                        theHandle);



    return err;

}

By implementing the GetParameterListHandle function in this way, you reduce the problem to supplying an appropriate 'atms' resource with your component.

Adding an 'atms' Resource to your Component

Tweening Parameters